home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 43 / Mac Magazin and MacEasy Magazine CD - Issue 43.iso / Software / Online / MultiMode ƒ / Docs - TEXT < prev    next >
Text File  |  1998-02-15  |  40KB  |  609 lines

  1.  
  2. MultiMode    Version 0.9.1                  February 15, 1998
  3.  
  4. Table of Contents
  5.  
  6.  1. Introduction
  7.  2. Basic Operation / Getting Started
  8.  3. Saving and Printing Data
  9.  4. Preferences
  10.  5. Morse Code Mode
  11.  6. Fax Mode
  12.  7. Baudot RTTY Mode
  13.  8. ASCII RTTY Mode
  14.  9. SITOR-A Mode
  15. 10. SITOR-B (FEC) Mode
  16. 11. Spectrum Display Mode
  17. 12. DTMF Mode
  18. 13. WWVB Time Decode Mode
  19. 14. ACARS Mode
  20. 15. Calibration Mode
  21. 16. SSTV Mode
  22. 17. Bit Rate Detection Mode
  23. 18. Proccessor Utilization Timing
  24. 19. Sound Capability Information
  25. 20. Known Bugs / Hints and Suggestions
  26. 21. Closing Comments / Suggestions, How you can help 
  27. 22. Registering MultiMode
  28. 23. Revision History
  29.  
  30.  
  31. 1. Introduction:
  32.  
  33. MultiMode allows you to decode several digital modes on your Mac. Best of all, MultiMode is shareware!  Please read section 22 to discover how you can register your copy.
  34.  
  35. I am now releasing a 68K version of MultiMode, for non-PowerPC systems.  I don’t know if 680x0 systems can handle the required processing load, so please report back your results if you run the 68K version. If I don’t hear positive results, I will probably stop releasing the 68K version, since I don’t want people to waste their time downloading a program that doesn’t work.
  36.  
  37. I've done all testing on a PowerComputing PowerCenter Pro 180 (604e). I'm anxious to hear how MultiMode performs on other machines.
  38.  
  39. Why did I write it? I've always been disgusted with the lack of decent ham/radio software for the Mac. Why should the wintel boys have all the fun? I've written several other Mac radio related programs in the past (check my web page for details), and have often had requests for a CW/RTTY/FAX/etc decoder for the Mac.
  40.  
  41. Eventually I'd like to add full support for other modes (SSTV, etc). That's where you come in (more details about that later on). 
  42.  
  43. The user interface has undergone massive changes since the previous version (I hope for the better!). Menu selections are gone now, a small window just under the menu bar contains small buttons to select the various modes and settings. This window (called the Signal Window) also displays the received signal, to help with tuning your radio.
  44.  
  45.  
  46.  
  47. 2. Basic Operation:
  48.  
  49. Connecting your radio to your Mac...
  50.  
  51. You simply need to connect the audio output of your radio to your Mac’s audio input (this is thejack on the back, usually with a little microphone icon). A few models come with audio input cords, most don’t. Also, some models expect an actual microphone to be connected, and require a small adapter (usually included) to allow direct audio to be connected. 
  52.  
  53. Also, you probably want to tap the audio from your radio’s headphone or external speaker jack, rather than a line level or “Record” output, which may be too low in amplitude.
  54.  
  55. Basic Operation...
  56.  
  57. The large buttons on the left side of the Signal Window select the mode of operation - CW, RTTY,  FAX, etc. or one of the signal tuning aids. 
  58.  
  59. The smaller buttons on the right hand side select various options for each mode, things like the baud rate, inversion, etc. As they are mode specific, the number of buttons and their use changes as you change decoding mode.
  60.  
  61. Two windows are displayed. One [usually] shows the audio input, so you can adjust tuning and volume levels. The other is the display of the decoded text or image. There are no provisions to print the text or image, although this will come in time.
  62.  
  63. The following sections describe operation for each mode. Please take the time to read the sections for the modes you’re interested in decoding. 
  64.  
  65. One general tip - watch the audio volume levels. If the audio volume is too high, the audio can be clipped, which will cause lots of errors (garbage) to be displayed while decoding. So, if the decoding doesn’t seem to be working very well, try turning the volume on your radio down before you try turning it up!
  66.  
  67.  
  68. 3. Saving and Printing Data:
  69.  
  70. There are several options under the File  menu to save or print decoded information:
  71.  
  72. New Log File...
  73. This allows you to start up a log file. All subsequent text decoded will be saved in this file. Ideal for unattended monitoring.
  74.  
  75.  
  76. Open Log File...
  77. Similar to the above, except that it appends new information on to the end of an existing text file.
  78.  
  79.  
  80. Close Log File...
  81. Stops writing decoded text to a log file, and flushes any unwritten text to the file. You must select this option when you are done storing interceptions to a file, or some information may be lost. 
  82.  
  83.  
  84. Save PICT...
  85. This allows you to save a FAX picture to disk. It is stored as a PICT file. The creator/type IDs are set for opening with JPEG Viewer, although any of the popular image applications may be used. 
  86.  
  87.  
  88. Save Text As...
  89. This allows you to save the decoded text to disk. It is stored as a plain text file. The creator/type IDs are set for opening with TeachText or SimpleText, although any of the popular word processors or text editors may be used. 
  90.  
  91.  
  92. Page Setup...
  93. The usual Page Setup.
  94.  
  95.  
  96. Print...
  97. This allows you to print decoded information. Right now only faxes can be printed, I hope to add support for printing text soon.
  98.  
  99. Under the Edit  menu, there are seevral options:
  100.  
  101. Copy
  102. This allows you to copy the decoded text or Fax, depeding on which window is selected. Right now, it only selects all of the decoded text, I hope to add support for selecting a portion of the text.
  103.  
  104. If you want to be able to copy a Fax image, you need to make sure you give MultiMode enough memory, as faxes tend to be quite large. I would suggest 10000K or so, some experimentation may be necessary.
  105.  
  106.  
  107. Clear
  108. This allows you to clear the text window. To clear the Fax window, hit the spacebar.
  109.  
  110.  
  111. Preferences...
  112. The Preferences are fully explained under their own section, which is next.
  113.  
  114.  
  115.  
  116.  
  117.  
  118. 4. Preferences:
  119.  
  120. Several different sets of preferences may be set, one for each mode of operation, plus a few general settings. They are described below.
  121.  
  122.  
  123. General Settings:
  124. Timing Delta - Used to correct the slight variance in timing between different computers. This value is automatically set by the Calibration mode. See the section on that mode for more information.
  125.  
  126. Speak Decoded Text- If you have the Speech Manager installed, checking this option will have MultiMode speak each word as it is decoded. Warning! This can become very irritating if a lot of garbled text is present. And even if it isn’t... Also, make sure that you really have the Speech Manager present, otherwise your system may bomb. You may need to set the speaking rate to be very fast with RTTY stations. 
  127.  
  128. *Speech has been ?temporarily? disabled. 
  129.  
  130. Reg Code - Used to enter the code for after you have registered MultiMode.
  131.  
  132. ACARS Mode Settings:
  133.  
  134. Use ACARS.LST Plane Listing File - Instructs MultiMode to check the plane’s registration number against the plane listing in the ACARS.LST file, to print additional information. See the ACARS documentation section for more details.
  135.  
  136. Replace chars with parity error with ~ - Characters which are received with parity errors will not be printed, instead a tilde (~) character will be printed.
  137.  
  138. Suppress packets with parity errors - Packets with parity errors will not be displayed. Useful to supress garbled packets.
  139.  
  140. Use DACARS Format - Alters the format of displayed packets, to more closely match the format required by the DACARS program, a shareware program for the PC which 
  141.  
  142.  
  143. Sound Input Settings:
  144.  
  145. Enable Sound Play-Thru - Checking this box enables the audio from your radio (through the microphone input) to be played out your Mac’s sound output, to any external speakers you may have.
  146.  
  147. Enable AGC - Enables the Automatic Gain Control (AGC) of your Mac’s sound input port, if it has this ability.
  148. 5. Morse Code Mode:
  149.  
  150. The audio from your radio is displayed in the Signal Window in an amplitude vs time basis. The audio is sampled in one half second chunks, which is evident in the update of this window. Four lines are also displayed - two horizontal and two vertical. 
  151.  
  152. The two horizontal lines are the thresholds for detecting a signal. The ambient noise level should be below the bottom line, the code signal should be above the upper line. The more separation between the two, the better. Adjust your radio's volume and tuning accordingly. The program's audio filter is centered for 750 Hz. When receiving CW, your radio’s AGC should of course be turned off. 
  153.  
  154. The two vertical lines move to show where new data is being placed, and where data is being read. There is a buffer in the area between the two lines. If the speed of the received code is too slow, so that dashes (or even dots) exceed the width of this buffer, you may have decoding problems. 
  155.  
  156. Several buttons are available in this mode. The seven three allow you to select the receive speed, either 5, 7, 10, 13, 16, 20, 26, or 34 wpm. The next button (with the question mark '?') allows you to have the program automatically select the speed, based on previous audio captured. The program defaults to 13 wpm.
  157.  
  158. The last button (with the red X) clears the speed buffer. This should be used when you've tuned in a new station, or the station has changed speed, or a lot of noise/static was received. Use this button if the program seems to select erroneous speeds.
  159.  
  160. There is a text window where the decoded text is displayed. You will notice a slight delay between when each character is received, and when it is actually displayed. This is normal. Presently, a character isn't displayed until the next one is received, which means that the last character of a message may never get printed; this will be fixed.
  161.  
  162. The spectrum display mode is very handy to use when trying to tune in a station.
  163.  
  164.  
  165.  
  166. 6. Fax Mode:
  167.  
  168. When you start decoding in fax mode, a window (titled Fax Window appropriately enough) appears, showing the decoded fax document in real time. Proper tuning of your receiver is necessary to correctly decode and view the fax. If the image appears negative (white on black) try changing from USB to LSB or vice-versa. I've found that you need to very carefully tune the radio, to achieve proper reception. Note that proper tuning for FAX decoding may NOT mean tuning your radio to the actual frequency of the station, some offset may be necessary.
  169.  
  170. Presently, only 120 line/minute faxes can be decoded. This is the standard for Weather Fax. Support for other modes can be added in the future.  I've also added support for  gray scale display, up to 256 shades. 
  171.  
  172. Chances are, when you start to decode a fax, you won't be correctly aligned in the horizontal direction. Pressing the left arrow or right arrow key, while holding down option will slightly shift the decoding to the left or the right. Please note that only lines received after this are shifted, old information isn't.
  173.  
  174. If you find that the picture is slanted, then the Timing Delta in the Gneral window of the Prefenerences will have to be adjusted. This can be done manually, or with the Calibration mode. If you wish to do it manually, then here’s the procedure: If you find that vertical lines slant to the left as they go down, then the Timing Delta must be made more negative. If vertical lines slant to the right as they go down, then the Timing Delta must be made more positive. 
  175.  
  176. When you reach the bottom of the window, no new image information is displayed. You can press the spacebar to start overwriting at the top of the window.
  177.  
  178. It is now possible to scroll around the fax window. The stored fax image is 1280H by 1536V pixels. You can view any 640 by 480 portion of the image by using the up/down/left/right arrow keys. It may be possible to screw up alignment by moving around too much, this was a problem with the 680x0 version.  (presumably because too much time is spent sloshing pixels around). If this occurs, I would suggest waiting a second or two between each press of the arrow keys when scrolling around the image.
  179.  
  180.  
  181.  
  182.  
  183. 7. Baudot RTTY Mode:
  184.  
  185. Baudot is the standard mode for transmitting teletype ofver shortwave radio. It uses a 5 bit code, which only allows for 32 symbol total, obviously not enough for all the letters, digits, and punctuation. Therefore, two special characters may be transmitted - letters shift (LTRS) and figures shift (FIGS). These two modes determine which character will actually be printed when a 5 bit symbol is received. 
  186.  
  187. Tuning:
  188.  
  189. While in the Spectrum Display  mode, tune your radio so that two spikes are visible, representing the mark and space tones. You want to mark tone (the lower frequency) to be centered as close to 1900 Hz as possible. Then take a note of the frequency of the space tone. The difference in frequency between the mark and space tones is referred to as the shift. 
  190.  
  191. Go to the Baudot mode, and select the correct shift frequency (the 170, 250, 450, 600, 850 buttons). Select the closest shift if the station’s shift is not exactly one of the available values.
  192.  
  193. When properly tuned, the mark/space tones are represented by black and white pulses. Gray means the audio tone is neither a mark or space. If you see gray mixed in (or all gray), then either the station isn’t properly tuned in, or the shift isn’t correct. 
  194.  
  195. Select the combination of speed and polarity (Normal or Inverted) for proper display of decoded text.
  196.  
  197. The various buttons in the Signal Window perform the following operations:
  198.  
  199. The 170, 250, 450, 600, 850 buttons select the shift frequency.
  200.  
  201. The 45, 50, 56, 75, 100, and 150 buttons select the baud rate. 
  202.  
  203. The N button selects Normal shift, the I button selects Inverted shift. 
  204.  
  205. The ABC button acts as an LTRS shift, and will return the program to letters mode, from figures mode. Very useful if a burst of noise shifts the program into numbers mode. 
  206.  
  207.  
  208.  
  209. 8. ASCII RTTY Mode:
  210.  
  211. This mode behaves very much like Baudot mode. Different speeds are available, representing the baud rates commonly found for ASCII transmissions.
  212.  
  213. Please refer to the Baudot RTTY section for details on using ASCII mode.
  214.  
  215.  
  216.  
  217.  
  218. 9. SITOR-A Mode:
  219.  
  220. SITOR-A mode sounds very distinctive, with a chirping sound. In this mode, three characters are transmitted at a time. The receiving station then sends one character back, indicating whether or not the three characters were correctly received. If not, they are re-transmitted. Each cycle takes 450 milliseconds, so you hear two “chirps” per second.
  221.  
  222. You will notice two types of chirps are heard, one longer than the other. The longer chirp is the data, the shorter chirp is the acknowledgement from the receiving station. Often, you may only be able to hear one of the stations from your location. You must be able to hear the longer chirp to decode data.
  223.  
  224. The BAD or OK lamp will flash as each packet is received. This can help in properly tuning in the station. Only SITOR-A is supported at this time, Mode for SITOR-B (FEC) will eventually be added. When you can only hear the receiving station transmitting the ACK/NAK symbols (a shorter chirp sound), the OK lamp will flash BLUE, to indicate that something is being received, although it cannot be decoded.
  225.  
  226. You'll notice that three colors are displayed in the signal window - black, white, and gray. The black and white colors represent valid mark/space tones being received, the gray means neither tone is present. Normally you'll see a burst of white/black bits, surrounded by gray. When you first tune in a SITOR-A station, it may take MultiMode a few seconds to properly synchronize on the signal. 
  227.  
  228. The spectrum display mode is very handy to use when trying to tune in a station.
  229.  
  230.  
  231.  
  232.  
  233. 10. SITOR-B (FEC) Mode:
  234.  
  235. This mode can be used to monitor FEC and NAVTEX transmissions at 100 baud. 
  236.  
  237. NAVTEX transmissions may be found on 518 kHz. 
  238.  
  239. There are three indicators, marked PHASE, BAD, and OK.
  240.  
  241. The PHASE indicator will light up blue when phasing signals are being received. These are typically sent at the beginning and end of transmissions, and during transmissions as filler. 
  242.  
  243. The BAD OK indicator will light up red when garbled or invalid characters are being received.
  244.  
  245. The OK indicator will light up green when valid characters are being received.
  246.  
  247. When first tuning in a station, the BAD indicator will light up, until the reception is synchronized with the transmission. It may also light up during reception, if the lock on the signal is lost. 
  248.  
  249.  
  250. 11. Spectrum Display Mode:
  251.  
  252. This mode is selected by clicking on the FFT button.
  253.  
  254. It displays the spectrum of the received signal. It is very useful for properly tuning in a station, and finding the shift rate of an RTTY station. 
  255.  
  256.  
  257. The above sample shows an RTTY station properly tuned it. Notice that the lower frequency has been centered on 2100 Hz, by carefully adjusting the radio’s tuning knob. The shift may be directly read by looking at the difference between the Mark and Space frequencies, in this case around 550 Hz. Selecting the 600 Hz shift option will allow the signal to be properly decoded (presuming the correct speed is selected, and the station isn’t encrypted).
  258.  
  259. [note: proper RTTY tuning requires tuning to 1900 Hz now, the picture needs to be changed]
  260.  
  261. 12. DTMF Mode:
  262.  
  263. This mode will decode DTMF. (“Touch Tone” which is probably a trademark of the telephone company) The decoded digits are displayed in the text window. 
  264.  
  265.  
  266.  
  267. 13. WWVB Time Code Mode:
  268.  
  269. This mode decodes the time code information transmitted by station WWVB, on 60 kHz. It does not decode the time code transmissions from WWV or WWVH on shortwave. You need a receiver capable of tuning the low end of the longwave band.
  270.  
  271. Tune your receiver to 60 kHz using CW or sideband mode. Adjust the tuning and volume so that the pulses dispayed in the signal window are clean, and match the beeps you hear from the radio. 
  272.  
  273. There are two status LEDs - BAD and DATA:
  274.  
  275. BAD flashes RED if a WWVB pulse is not received, or if the pulse is not properly synchronized. When WWVB is first tuned it, this LED will flash, until the reception is correctly synchronized.
  276.  
  277. DATA flashes GREEN when a proper WWVB pulse is received. 
  278.  
  279. DATA flashes BLUE when a WWVB position identifier pulse is received, normally every ten seconds. 
  280.  
  281. Two position identifier  signify the beginning of the next minute. At this time the received time information for the previous minute is displayed.
  282.  
  283.  
  284.  
  285. 14. ACARS Mode:
  286.  
  287. ACARS is the acronym for Aircraft Communications Addressing and Reporting
  288. System. It is a data transmission between airplanes and ground stations. The purpose is to handle many types of traffic that would normally be done by voice in the past. ACARS transmissions are on VHF. The following frequencies are commonly used:
  289.  
  290. 129.125 MHz
  291. 130.025 MHz
  292. 130.450 MHz
  293. 131.475 Mhz
  294. 131.550 MHz
  295.  
  296. As with all other VHF-Aeronautical transmissions, AM mode is used. Most scanners automatically change to AM mode when tuning the 108-136 MHz aircraft band, but you may want to verify your scanner does this.
  297.  
  298. The transmissions sound like data bursts ranging from about 0.2 second to 1 second in length. Due to the high altitude of aircraft, transmissions from aircraft may be monitored for several hundred miles. Those living close to airports may also hear the ground transmissions sent to aircraft.
  299.  
  300. Tuning in ACARS transmissions is fairly easy - just select ACARS mode and adjust the radio’s volume for proper decoding. Please note - it is very important to have the squelch of your radio completely off, that is, so you always hear the background static. The squelch action of any radio is too slow, and you’ll miss the packet!
  301.  
  302. You will find that many transmissions are garbled or not decoded. This is a very difficult mode to demodulate without external hardware, so good reception quality and strong signals are required. 
  303.  
  304. MultiMode displays the transmitted packet, and parses out some of the information, such as the plane’s wing number, flight number, etc. It does not attempt to parse out other specific information in the text portion of the packet, which is displayed on the second line. A timestamp is also displayed on the first line. 
  305.  
  306.  
  307. Here is an example of a received ACARS transmission:
  308.  
  309. .N227AA  5Z 2   [13 Sep 97   20:57:06]
  310. 5651 AA0742  OS LGA /ALT00000122
  311.  
  312. N227AA is the aircraft registration, note the leading periods, to force it to 7 characters.
  313. 5Z is the message type
  314. 2 is the downlink block identifier
  315. [13 Sep 97   20:56:51] is the date and time, added by MultiMode
  316. 5651 is the message sequence, minutes and seconds past the hour
  317. AA0742 is the carrier and flight number (American Airlines flight 742)
  318. OS LGA /ALT00000122 is the text message sent, for those modes which include a message
  319.  
  320. There is an LED type indicator under called PACKET in the Signal Window which lights up green when a good ACARS packet is received, and red if a packet is received but it is bad. In addition, statistics are displayed for the number of good and bad packets received, along with the percentage of good packets. This is useful for adjusting your radio setup, obviously you want to maximize the percentage of packets which are good.
  321.  
  322. You may create a file called ACARS.LST, which is a listing of plane registration numbers, along with text that you may enter. This file is read in when MultiMode first starts up, and must be located in the same folder as the MultiMode application. When a packet is decoded, the plane registration number is compared to the registration numbers of the planes in the ACARS.LST file. If a match is found, the text from that line of the file is displayed after the timestamp. You may use this file to display text or comments about each aircraft. 
  323.  
  324. An example of the file format follows below:
  325.  
  326. .N814US This is plane number 1
  327. .N320US This is plane number 2
  328. .NIM5AA This is plane number 3
  329. .N781NC This is plane number 4
  330. .N609AA This is plane number 5
  331.  
  332. Note that the first 7 characters of each line are the plane registration number, followed by a space. The rest of the line contains the text to be displayed. Leading periods are required to force the registration number to be seven characters long.
  333.  
  334. If you are not interested in using the ACARS.LST file, you may simply remove it from the MultiMode folder.
  335.  
  336.  
  337. Here are some Web Pages devoted to ACARS which you may find of interest:
  338.  
  339. http://www.grove.net/~acarslink/        ACARS-Link
  340. http://patriot.net/~jetset/acars.html        Northern Virginia ACARS Page
  341. http://www.euronet.nl/users/bart_b/        Bart 'Beaver' Hoekstra ACARS Page
  342. http://web.inter.NL.net/hcc/Hans.Wildschut/    ACARSWeb
  343.  
  344. There is also the ACARS mailing list, which is handled by (but not run by) Grove. Requests to join should be sent to majordomo@grove.net with the text "subscribe acars" in the BODY of the e-mail.
  345.  
  346. There is a book out on ACARS, called  "UNDERSTANDING ACARS, 3rd Ed." written by Ed Flynn, with Robert E. Evans. This book should be available at your local shortwave store. I bought my copy from Universal Radio. It does a good job of explaining the formats of the various messages.
  347.  
  348. Robert E. Evans also writes the column “ACARS Downlink”, which appears bi-monthly in Popular Communications magazine.
  349.  
  350. BTW - I had never even heard of ACARS before someone mentioned it’s existance and asked if I could add support for it. After spending many hours monitoring ACARS transmissions (while writing/debugging the ACARS code), I became hooked on it. Most routine traffic which used to be handled by voice is now sent via ACARS.  If you haven’t tried ACARS mode, and have a radio/scanner that tunes the VHF aircraft band, give it a try! 
  351. 15. Calibration Mode:
  352.  
  353. This mode is used to calibrate MultiMode to the particular timing of your computer. Each computer runs at a slightly different speed, which means that the audio sampling may not be exactly the correct value. Any error in sampling will cause FAX and SSTV images to be skewed and distorted. You only need to calibrate MultiMode once for your machine, the calibration is saved in your MultiMode preferences file.
  354.  
  355. The easiest way to calibrate is to tune into WWV or WWVH, the standard time stations, which transmit on 2.5, 5, 10, 15, and 20 MHz. (Users outside of North America can use whatever time stations are audible in their region)
  356.  
  357. This mode draws a new horizontal line on the screen every second. The second pips from the time station should be displayed as a black dot on each line.  There may also be some extraneous small dots due to noise or other audio. These black dots should start to form a vertical line. If the computer’s timing is correct, this line should be perfectly vertical. (There are a series of gray vertical lines spaced across the page to help you determine if the black line is indeed vertical)
  358.  
  359. If the line is slanted one way or the other, you should use the + and - keys on your keyboard to adjust the timing offset, which is displayed as the Delta in the calibration window. Each press of the + or - key will increment or decrement Delta by 0.1. Holding down the option key while you press + or - will increment or decrement by 1.0, to speed things up. 
  360.  
  361. After finding the correct Delta for your machine, select Preferences from the Edit menu. In the box for Timing Delta, under General settings, there should be a number equal to the Delta from the Signal Window. Click the OK button, and the Delta will be saved in your preferences file, so that it is automatically loaded the next time you use MultiMode.
  362.  
  363. You may want to record the Delta for your machine, so that in case you should lose your Preferences file, you can simply re-enter it, rather than going through the calibration procedure again.
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370. 16. SSTV Mode:
  371.  
  372. This mode is under contruction. It seems to decode M1 under some conditions, but much more work is necessary.
  373.  
  374.  
  375.  
  376. 17. Bit Rate Mode:
  377.  
  378. (The funny little digital waveform button)
  379.  
  380. This mode will help you determine the bit rate of an RTTY station. The length of each bit received is converted into an effective baud rate. The bit lengths are sorted into bins, with the resulting histogram displayed, with a bit of averaging, to get more accurate results and offset the effects of noise. Therefore it takes several seconds to get a good reading.
  381.  
  382. The following picture is the analysis of a 75 baud Baudot transmission:
  383.  
  384. The three x-axis are the baud rate of the signal. Why three? Well, imagine how two adjacent bits of the same value (0 or 1) are read by the computer - they appear as one bit which is twice as long. The same thing with three adjacent bits of the same value. So some bits of a 100 baud transmission would appear as 50 baud bits, or even 33.3 baud bits. 
  385.  
  386. In this example, the main peak is at 75 baud, which is what we would expect. Then there are smaller peaks at what would be 37.5 baud (75/2) and 25 baud (75/3). Hence the second and third axis, where these smaller peaks also read as 75 baud.
  387.  
  388. But what about the other peak around 50 baud? It is due to the stop bits, which are typically 1 1/2 bits long. A stop bit at 75 baud appears like a 50 baud data bit. This also explains the other small peak between the second and third 75 baud peaks - it is the result of a stop bit, with the data bit preceeding it having the same value as a stop bit. 
  389.  
  390.  
  391.  
  392.  
  393. 18. Processor CPU Time:
  394.  
  395. In the upper right hand corner of the Signal Window, you will see the amount of processor  time required for the current mode, in ticks (1/60 of a second).  If you could, please report this time for each mode that you use. Please note whether or not you were actually decoding data in this mode, since slightly less time is used if there’s no signal to decode. This time will be very useful to me in helping to speed up MultiMode.
  396.  
  397. Here are the CPU times I’ve found when running on my PowerCenter Pro 180:
  398.  
  399.         180MHz 604e
  400. CW        2
  401. RTTY        6
  402. ASCII        6
  403. FAX        14
  404. SITOR    6
  405. Spectrum    18
  406. ACARS    2-10
  407.  
  408. The ACARS varies so much because little processing is required except when there is an actual packet to process.
  409.  
  410.  
  411. 19. Sound Information:
  412.  
  413. There’s a pseudo-secret window you can bring up, which prints out all sorts of gory information about sound input on your Mac. This may be of help to me in debugging MultiMode on systems where it doesn’t properly run. Here’s how to get to this window:
  414.  
  415. 1. Open the “About MultiMode...” window from the Apple Menu.
  416.  
  417. 2. In the About Window, you’ll see a bunch of colored blinking dots on the right hand side. Click on them. (clicking anywhere else clears the About Window)
  418.  
  419. 3. You can write down what you see, or press Shift-Command-3 to take a snapshot (this of course saves the image of your screen as Picture 1, Picture 2, etc... on your startup volume). You can email this snapshot to me.
  420.  
  421.  
  422. 20. Known Bugs, Hints and Suggestions:
  423.  
  424. Some users have been reporting conflicts with RamDoubler. If you have RamDoubler, and are experiencing problems you may want to try disabling it to see if that helps. The same goes with other extensions - you may want to try disabling them if you’re having problems, to see if that helps.
  425.  
  426. Don't try to do too much multitasking when decoding. If your Mac is busy and can't get a sound sample in time, it will be lost, causing garbled display. Holding down the mouse button can cause this also. (It's not a bug, it's a feature!) Quit all other applications, if possible. 
  427.  
  428. In Fax mode, all drawing is done to an offscreen port with an 8 bit pixel depth. If CPU utilization is too high in fax mode, you may want to set your monitor pixel depth to 256 colors, this will speed things up. (For example, on my PowerCenterPro 180 system, the CPU time is around 10% in Fax mode, when I am in millions of colors. If I switch to 256 colors, it drops to 3%. On this system, it isn’t much, but on slower systems, it can be critical. )
  429. You also may wish to try not running other applications in the background.
  430.  
  431. Take time to make sure your signal is properly tuned in, with minimal interference. That's the best way to get clean copy. Don't overdrive the audio input into the Mac either, that will only distort the signal. If the audio volume is too high, the audio can be clipped, which will cause lots of errors (garbage) to be displayed while decoding. So, if the decoding doesn’t seem to be working very well, try turning the volume on your radio down before you try turning it up!
  432.  
  433.  
  434.  
  435.  
  436.  
  437. 21. Closing Comments:
  438.  
  439. I hope you enjoy using the program. Please forward your comments and suggestions, along with any bugs to me. I'll try my best to help you out. Email is preferred, and I cannot provide any support over the telephone. Please always mention which version you are using, and what type of Mac system you have (model, System version, etc). As always, try starting up with extensions disabled if you have problems.
  440.  
  441. The documentation will be improved over time,  suggestions for areas that need additional clarification are always welcome.
  442.  
  443. I would appreciate it very much if everyone who tries this program emails me to let me know whether or not it works (including the version number, and your system configuration as described above). This will let me build a matrix of functional system configurations. Please also include the CPU utilization times for each mode you use, so I can see how different systems behave. This will help me tune the software so that all users may benefit.
  444.  
  445. What other types of digital signals are you interested in decoding? Tell me, and I'll do my best to add support for those modes. Even better, send me a cassette tape with a clean recording of that mode, so I have some audio to use for testing purposes. (And if you could include a printed copy of the text sent, that would really be appreciated!) 
  446.  
  447. I am presently working on adding support for the following modes:
  448.  
  449. SITOR-B (FEC) 
  450. RDS (The format for transmitting data over am FM subcarrier)
  451. SSTV (I could really use some clean recordings of SSTV modes, better yet some SSTV audio captured directly from the computer sending it, without any noise or static)
  452.  
  453. These modes may appear as buttons available in the Signal Window, but are for my testing purposes only. Don’t expect them to be very functional at this point!
  454.  
  455. Also, if you’d like, you can request to be automatically informed, via email when, when a new version of MultiMode is available from my web site. Just send me email requesting this, along with your return email address. It’s that easy.
  456.  
  457. The most recent version will always be available at the following URL:
  458. http://www.access.digex.net/~cps/sss14.html
  459.  
  460. 22. Registering MultiMode:
  461.  
  462. MultiMode is shareware. The registration fee is only $25. Take a moment to compare this to the prices charged for commercial decoding programs, which, in addition to being many times more expensive (often by around a factor of ten), are also only available for the PC.
  463.  
  464. By registering your copy of MultiMode, you’ll help support my efforts to develop newer versions, which will further increase the number of modes which can be monitored, and the features available. I’d like to be able to continue developing new versions of MultiMode, so that we Mac users won’t be forced to abandon the Macintosh for the wintel platform.
  465.  
  466. Paying for MultiMode is fairly simple. Open the Register program that accompanies My Program. Enter your name, your email address, and the number of single user licenses you desire for each program you wish to purchase. Save or Copy or Print the data from the Register program and send the data and payment to Kagi. More specifics on the Register program to follow. Kagi handles my payment processing.
  467.  
  468. If paying with Credit Card or First Virtual, you can email or fax the data to Kagi. Their email address is sales@kagi.com and their fax number is +1 510 652-6589. You can either Copy the data from Register and paste into the body of an email message or you can Save the data to a file and you can attach that file to an email message. There is no need to compress the data file, it's already pretty small. If you have a fax modem, just Print the data to the Kagi fax number. 
  469.  
  470. Payments sent via email are processed within 3 to 4 days. You will receive an email acknowledgement when it is processed. Payments sent via fax take up to 10 days and if you provide a correct internet email address you will receive an email acknowledgement. 
  471.  
  472. If you are paying with Cash or USD Check you should print the data using the Register application and send it to the address shown on the form, which is: 
  473.  
  474.               Kagi
  475.               1442-A Walnut Street #392-SZ
  476.               Berkeley, California 94709-1405
  477.               USA
  478.  
  479.  
  480. You can pay with a wide variety of cash from different countries but at present if you pay via check, it must be a check drawn in US Dollars. Kagi cannot accept checks in other currencies, the conversion rate for non-USD checks is around USD 15 per check and that is just not practical. If you have a purchasing department, you can enter all the data into the Register program and then select Invoice as your payment method. Print three copies of the form and send it to your accounts payable people. You might want to highlight the line that mentions that they must include a copy of the form with their payment.  Kagi can not invoice your company, you need to act on my behalf and generate the invoice and handle all the paperwork on your end.  
  481.  
  482. Please do not fax or email payment forms that indicate Cash, Check or Invoice as the payment method. As far as we know, there is still no technology to transfer physical objects via fax or email and without the payment, the form cannot be processed. Payments send via postal mail take time to reach Kagi and then up to 10 days for processing. Again, if you include a correct email address, you will hear from Kagi when the form is processed. 
  483.  
  484. Please make sure you include your email address with your payment. That way I can send the registration code to you.
  485.  
  486. Thanks again for giving MultiMode a try.  73's !
  487.  
  488. Chris Smolinski
  489. 4708 Trail Court
  490. Westminster, MD 21158
  491.  
  492. email:   cps@access.digex.net
  493. Web:      http://www.access.digex.net/~cps
  494.  
  495.  
  496.  
  497. 22. Release History:
  498.  
  499. 0.9.1  2/15/97
  500. 1. Implemented SITOR-B / FEC / NAVTEX mode. Hopefully this will be the foundation for
  501.     support of additional synchronous modes.
  502.  
  503.  
  504. 0.9.0  1/2/97
  505. 1. Completely re-wrote FAX receive routine. It seems to decode much better now, and
  506.     decodes in gray scale.
  507. 2. Added additional morse code speed options (7, 10, 16, 26, 34 wpm added)
  508. 3. Changed RTTY center frequency to 1900 Hz (from 2100 Hz)
  509. 4. Changed 110 baud button to 150 baud for RTTY mode
  510. 5. Added statistics display to ACARS mode showing percent and number of good/bad
  511.     packets.
  512. 6. Tweaked morse code receiving routine.
  513. 7. Fixed bug in morse code mode - the letter P was displayed as an H.
  514. 8. Improved memory management, reducing memory required by around half.
  515. 9. Sound input is interrupt driven, so data shouldn’t be lost if performing other background
  516.    tasks (to a point of course).
  517. 10. Printing faxes should work, the text window can’t [yet] be printed.
  518.  
  519.  
  520. 0.4.7  9/19/97
  521. 1. Removed Speech (temporarily?) as this was causing problems for some users, especially those with OS8.
  522.  
  523.  
  524. 0.4.6  9/14/97
  525. 1. Overhauled Preferences substantially, it is recommended that this section of the documentation be reviewed to see what has been added
  526. 2. Added ability to save all subsequent text output to a log file, ideal for unattended ACARS monitoring. 
  527. 3. Continued to improve Bit Rate mode.
  528. 4. Added ability to have MultiMode speak decoded text, enabled in the 
  529. Preferences->General window. 
  530.  
  531. 0.4.5  9/10/97
  532. 1. Fixed a problem where you often had to repeatedly click on buttons to actually activate
  533. them.
  534. 2. Added tighter audio filtering to CW mode, this should help reject more interfering signals. It may make tuning a little different than before. 
  535. 3. Added display of the percent CPU time being used, to help gauge processor loading
  536. 4. Major internal software changes, which aren’t visible to the user, but should make it easier to add some additional modes in the future. 
  537.  
  538.  
  539. 0.4.4  8/31/97
  540. Fixed (again!) a major bug that would cause crashing when clicking on or moving/resizing the text display window. Hopefully this bug will stay fixed this time!
  541. Added time display to ACARS mode.
  542. Added support for ACARS.LST file for plane information display.
  543. Added display of date/time stamp with ACARS loggings.
  544.  
  545.  
  546. 0.4.3  8/29/97
  547. Added Preferences.
  548. Added DTMF decoding support.
  549. Added Calibration mode to calibrate FAX and SSTV timing.
  550. Added support for saving text files and FAX pictures to disk.
  551. Modified 680x0 filter routines to speed them up.
  552.  
  553.  
  554. 0.4.2  8/23/97
  555. Fixed a major bug that would cause crashing when clicking on or moving/resizing the text display window.
  556. Added display of Processor CPU Time, to help gauge how busy a given system is.
  557. Changed format of ACARS display.
  558. Changed sampling period of ACARS mode, and data is buffered between reads, so packets aren’t lost if they occur inbetween updates. 
  559. RTTY mode now displays gray in the signal window if a mark or space tone isn’t present.
  560.  
  561.  
  562. 0.4.1  8/15/97
  563. Added support for ACARS mode.
  564. Added support for WWVB Time Code decoding.
  565.  
  566.  
  567. 0.4.0  8/3/97
  568. Now compiled for PowerPC, PowerMac now required.
  569. Started major changes to the operator interface.
  570. Improved audio filter routines for better noise immunity.
  571. Added support for SITOR-A
  572. Added FFT for spectrum display
  573. Added 600 Hz shift for RTTY
  574. Started to add automatic bit-rate detection for RTTY
  575.  
  576.  
  577. 0.3.2  4/2/97
  578. Added support for gray scale faxes
  579. Added ability to adjust sampling rate for faxes, to correct skewing of vertical lines
  580.  
  581.  
  582. 0.3.1  3/19/97
  583. Turned sound play-through back on, so you can hear the radio's audio through your Mac's speakers.
  584.  
  585.  
  586. 0.3.0  3/18/97
  587. Added support for Baudot RTTY.
  588.  
  589.  
  590. 0.2.1  3/16/97
  591. Added scrolling for fax reception.
  592.  
  593.  
  594. 0.2.0  2/23/97
  595. Added support for Weather Fax reception.
  596.  
  597.  
  598. 0.1.1  12/31/96
  599. Increased sampling frequency to 22 kHz.
  600. [Hopefully] fixed bug that caused crash if no signal present for too long.
  601. [Maybe] fixed a bug that caused a crash on some systems at launch.
  602.  
  603.  
  604. 0.1.0  12/29/96
  605. Initial release 
  606.  
  607.  
  608.  
  609. ©1997 Chris Smolinski